Sets the power state of a display device.

OSErr DMSetAVPowerState (
    AVIDType theID, 
    AVPowerStatePtr setPowerState, 
    UInt32 powerFlags, 
    Handle displayState
);

Parameter descriptions

theID

The ID number of the display device whose power state you want to change.

setPowerState

On return, this parameter points to a value that your application can use to set the power state of a display device.

powerFlags

A value that specifies the power state to which a display device can be set.

displayState

A handle to internal Display Manager information about the current display state.

function result

A result code.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when Displays 2.0 or later is present.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)